home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / zgebak.z / zgebak
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. ZZZZGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))                                                          ZZZZGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ZGEBAK - form the right or left eigenvectors of a complex general matrix
  10.      by backward transformation on the computed eigenvectors of the balanced
  11.      matrix output by ZGEBAL
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      SUBROUTINE ZGEBAK( JOB, SIDE, N, ILO, IHI, SCALE, M, V, LDV, INFO )
  15.  
  16.          CHARACTER      JOB, SIDE
  17.  
  18.          INTEGER        IHI, ILO, INFO, LDV, M, N
  19.  
  20.          DOUBLE         PRECISION SCALE( * )
  21.  
  22.          COMPLEX*16     V( LDV, * )
  23.  
  24. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  25.      ZGEBAK forms the right or left eigenvectors of a complex general matrix
  26.      by backward transformation on the computed eigenvectors of the balanced
  27.      matrix output by ZGEBAL.
  28.  
  29.  
  30. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  31.      JOB     (input) CHARACTER*1
  32.              Specifies the type of backward transformation required:  = 'N',
  33.              do nothing, return immediately; = 'P', do backward transformation
  34.              for permutation only; = 'S', do backward transformation for
  35.              scaling only; = 'B', do backward transformations for both
  36.              permutation and scaling.  JOB must be the same as the argument
  37.              JOB supplied to ZGEBAL.
  38.  
  39.      SIDE    (input) CHARACTER*1
  40.              = 'R':  V contains right eigenvectors;
  41.              = 'L':  V contains left eigenvectors.
  42.  
  43.      N       (input) INTEGER
  44.              The number of rows of the matrix V.  N >= 0.
  45.  
  46.      ILO     (input) INTEGER
  47.              IHI     (input) INTEGER The integers ILO and IHI determined by
  48.              ZGEBAL.  1 <= ILO <= IHI <= N, if N > 0; ILO=1 and IHI=0, if N=0.
  49.  
  50.      SCALE   (input) DOUBLE PRECISION array, dimension (N)
  51.              Details of the permutation and scaling factors, as returned by
  52.              ZGEBAL.
  53.  
  54.      M       (input) INTEGER
  55.              The number of columns of the matrix V.  M >= 0.
  56.  
  57.      V       (input/output) COMPLEX*16 array, dimension (LDV,M)
  58.              On entry, the matrix of right or left eigenvectors to be
  59.              transformed, as returned by ZHSEIN or ZTREVC.  On exit, V is
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZZZZGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))                                                          ZZZZGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))
  71.  
  72.  
  73.  
  74.              overwritten by the transformed eigenvectors.
  75.  
  76.      LDV     (input) INTEGER
  77.              The leading dimension of the array V. LDV >= max(1,N).
  78.  
  79.      INFO    (output) INTEGER
  80.              = 0:  successful exit
  81.              < 0:  if INFO = -i, the i-th argument had an illegal value.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.